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MACRO ASSEMBLER 



Az ASSEMBLER Programed szlnte elkt*p?eihetetlen, vagy legaUbbis 
nehezkes egy jol kezelhetfi, cimki*zhet6 forditd program nelkOl. A N6- 
vetkez6 leirtfs egy llyen ASSEMBLER forditoprogram kezel^sH £s hasz- 
nalatdt mutatja be. 

A macro indita'sa 

Az EDITOR- AS5EMBLER program a HomeLab-3-as gephez keszult, amelyet 
kaze ttardl a BASIC LOAD utasit4saVal lehet betolteni. 
Az epromban lev6 MACROT BASICBOL call 23810-el, ASSEMBLERBflL 
G3810-el, vagy a DEBUGGER programbrtl az (hosszu 0) billyentyii 

negnyom3s3val lehet inditanl. 

A program a g6p belsQ softver£b61 nagyon keveset haszna"!, wivel 
tinSlld editorral rendelkezlk. 

A program a szabad memoxia teriiletbfll Hex. 4300-ig terjedfi teriileten 
teriil el, de ezen kiviil az lndita'sa uta*n tdbb rerriszerv£lt6 tablet 
kgszlt a sajdt mQkod6s£hez . Igy Hex. 4300-ala" is keriil bel61e, ez£rt 
az alatta 16vfl teriiletet ne hasznald fel programoz8*sra . 

A KIADHAT6 PARANCSOK : 

- a parancsak egybetGssk 

- mirxlen parancs utan CR- kell 

* a parancsok kfit reszre vannak bontva, SltalSnos £s editor parancsokra 

ALTAIANS PARANC50K: 

H - a program letaroiasanak START 6s END cimelt mddosltja, 
formd tuna: H nnnn xxxx 
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■C - tttrli a SURCtE File tartalmSt a imteitato, ill. a N-val kifrhatt 
cimtfil cimig. 
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- csak Ores surcle-file esetSn adhatd ki UtaMnos feenmftfean. 
Uj program k^szitSsekor kell kiadni ezt a parancsot. Ekkor 
meojelenik az 1 sorszam 6s a kurzor. Ide maT a programodat 
frhatod. MincJen sort CR-el kail termini. A begipelt soc 
ne legyen hosszabb 1 k^pernyesornal . Minden CR utan uj sor- 
szamot ad automatikusan. A sorszamoknak csak ta^koztatas 
szempontja'bol van jelentfis^giik ! 

Az els6 utasiMsod lehetdeg ORG legyen vagy REM-nek 

megfelelfi; legyen, kulonben hibajelzest fogsz kapni. 
Ha a sorszam utan; gepelsz, akkor utana b«5rmilyen karaktert 
hasznalhatsz meg jegyzSsk^nt . Az utasitasok u«n Is haszn^l- 
hatsz megjegyz^st. 

Ha a sorszam ut*n CR.-t gepelsz, akkor a programirts uzem- 
■ratt (I) megs20nik. 

- Ha van SUftCLE File a meradrliban akkor Debuggerb61 tbrteri6 
meleginditSsnak felel meg. Ha a program irasa sor4n gSpeie- 
si hiWt kovetttl el 6s azt kl akarod javftani, akkor a 
sorszam uta> R-el i<§ P j k i az fras Uzemmddbtfl, majd "£" nyo- 
m^sa utan az utolj4ra l^tszo sort javithatod. Javftas utan 
CR-el kell a sort elkuldeni. 

- az el6zoleg az assemblies sorin keletkezett szimbolwn, ill. 

ciroke tiblazatot irjs ki rer.dezve, de elotte kifrp QftmiiH, 
ami annyit jelent, hogy megk^rdezi, hogy nova akarod kiiratni! 
A v^laszok lehetnek 
CR : llyenkor sehova nem irja ki 

- V : videdra, azaz kepernyfire 
• P ; printerre 

Vigy^zz! Ne haszn^lj nagyon hosszii cimk«ket, mivel azokat 
egy kiilbn tibl^zatban rakja le. 
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A tiblizdt igy nez ki: 



1 56COH 1 600DH 



EDI 1 SIMBOL 1 SURCLE FILE 

Ha hosszti szimbolumokat haszn^lsz, akkor ez a szimbtflum tabla~zat hamar 
megtelik 6s belegyalogolsz a programed elej^be 

- Az ORG-tol az elsa END pszeudo utasitasig terjedfl SURCLE File-t le- 
forditja Z-80 utasitasokra, egyben szintaktikai ellenfirzgst vegez, 
valamint elm 6s cimkesza'roltSst is. 
Elfizflleg megkerdezi, hogy nova forditsa le (OPCIDN) 
A valaszok lehetnek 

- V : videtfra 

- P : prlntetre 

- CR : fordita~5 elkesziil de ezt nem irja ki sehova, illetve 

nem lista*zza ki. 
Ha nagyobb programot akarunk leforditani, akkor CR-el erdemes va"la- 
szolni, mert igy kb. 4-szer olyan gyorsan forditja le mint kiiratas- 
sal. Ha forditis soran hibSt taiai, akkor hibaiizenetet kiild, 6s ki- 
lt Ja a hibds sor sorszam£t. 

H * kilepes a Macrobdl 

EDITOR : 

- ebben az uzemmodban lehet a mSr meglevft SUfiCLE-File-ban 
javitdsokat vegezni. 

- mlnden edit^lasi parancs a kepernySre utol.ia'ra kilrt sona 
vonatkozik . 

- ide mutat az editor belsfi pointere 

AlTAIJnQS EDITOR PARANC5GK : 

CR - a pointer a file elejexe megy, azaz az 1-es 

sz4mu sorra (*) 
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5P+CR - a pointer a file vegere megy (x) 

F2*oursor le - list^zas egyesevel lefe!6 

F2+cursor fel - UstazSs egyesevel felfele 

F2+SH+cursor le - listSzds 31 sorral elfire (*0 

F2+SH+cursor fel - lisWza's 31 sorral vissza (x) 

k (csak akkor rmjkodik ha egya*ltalan van mtt 51 sorral 
elore vagy visszafele listaznia.) 

I - hat4sa nem azonos az ures SURCLE-Filevel kiadhatd I-vel. 
Az utolsdnak kiirt sor utan lehet vele beszura~st csinilni. 
Oj sorszamot ad es a mbgbtte levfi sorszamokat automatikusan 
no veil eggyel, lgy kflmyen iehet bSrhova beszurni egy vagy 
tobb sort. CR utan tij sorszdmot ad, ekkor meg egy CR-el tu- 
dunk kilepni a beszura'sos uzemm6dbdl. 

- az utols6nak kiirt sort tbrll 

E - az utolsdnak kiirt sor ntfdositasa, az E kiadasa uta*n a kurzor 
az utolja'ra kiirt soron jelenik meg. Az utasit^s, ill. cimke 

mddositasa"t a Basicben megszokott mddon vegezziik. A mtfdositas 
vegen CR-el terminSlunk. 

CR - kilepes EDIT0R-b61 

A SURCLt FILE KIMENT ^SE: 

W - haiisa'ra megkerdezi a program nev£t. Lehetfleg rtftud nevet 

ad junk, inditsuk el a magnet, majti CR-eI elkeztijiik a kimen- 
test. 

A SURCLE FILE BETttLTfSE : 

R - hatasira a program Load Uzemmddba lep 
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ASSEWLER UTASIT&SQK: 

Az assembler a Z-80-as CPU utasitdsait ismeri, ez ki van egeszitve 

n£h£ny pszeudo utasita*ssal. 

Ezek; 

a./ ORG operandus 

az object-file kezdG hely£t hatarozzs meg, azaz a fordita*s ota*n 
milyen cimre kezdje el kisz4mitani a cimeket, illetve cimkgket. 

pld.: 

1 ORG 7000H 

2 RET 

A peldg alapjdn az els6 utaslta'st Hex. 7000- clmre rakja la a 

fordlttis soran. 

Az operandus egy szam, amely lehet Hex. vagy Decimal is 

pld.: 

DRG 7000H /Hex/ 

ORG 1220S /Dec/ 



b./ EQU operandus 




Szimbulumhoz ert^ket 


rendel 


pld. : 




11 PIPAC5: EQU 5000H 


/Hex/ 


12 LAP AT; HQU 1228B 


/Dec/ 



a tovSbbiakban ha PIPACS nevO szimbdlunra (cimktor) hivatkozunk» 
akkor a program a forditSs soran 3000-ret fog Srtelmezni 6s be- 
helyettesiteni. 

c./ L0AO operandus 

Az operandus altal meghatarozoti helyre tolti be az [BJEST 
programot. Hatasa a kovetkezo ORG-ig tart. 
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pld. : 

1. ORG 6000H 

2. LOAD BOO0H 

3. PUSH AF 

A fenti program alapjdn a fordita*s sorSn a lef orditott PUSH AF 
utasxtas Hex. 6000-es cimre szamitja ki, de a memorials Hex. 8000-res 
cimre rak^a le a programot. 

Ennek az eljartenak akkor latjuk a hasznat, ha pld. BOOQH-ra LOAQ- 
oljuk le kiprdbala's celjlbdl, de az abban szereplfi utasitdsok v£g- 
leges helye 600DH lesz. TehSt ha el akarjuk kerulni azt, hogy a 
forditas sora"n nehogy felullrjuk az Assembleriinket, azaz "r^gyalo- 
goljunk" akkor erdemes ezt az elkuldnitest alkalmaznunk, ugyanis 
az ORG a"ltal definidlt cimre kisza"mitja a pogramot, de a RAM te- 
ruletre az ORG nem tdlti be. Ezt a feladatot csak a LOAD hajtja 
vegre. 

d./ END (nines operandusa) 

A forrSsprogramot z4rja le, hasznalata kotelezfl, mlvel hianya 
hib$t okoz a forditas sorin. 

■ 

e./ OS operands 

A DS aperandusaban megadott sza*mi3 byte teriiletet foglal le az 
GBJECT-File-ban. 

pld.: 

1. ORG 7000H 

2. LOAD 70G0H 

3. VALTOZd: DS 5 

4. LD A8BH 

5. LD (VALT0Zti+3),A 

6. END 

A fenti program 7000-7005-ig terjedfi teriiletet lefoglalja es a 

7003-as rekeszbe betdlti A £rt£ket. 

A DS segitsegevel pld.: a rendszer- vdltozdinknak tudunk helyet 
biztositanl a programban. 
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f ./ OB operandusok, literalok, kifejez^sek 

A OB 32 operandus 6rt$k6t az OBOECT-File-ban generalja. 
Tobb operandus lehet vessz6vel elvalasztarwa 

pld.: 

1. ORG 7000H 

2. LOAD 7000H 

3. BUFF: OB 1, 2, 3,4,ERTEK, 5BH 

4. ENO 

A fenti p£ia$ban Hex. 7000-re lerakja 1-et 

7001-re 2-ot 
7002-re 3~at 
7003-re 4-et 

A 7004-es rekesztOl kezdfidoen lerakja a2 "ERTEK" sz6, ill 
kifejezfe Hex. kfidjait. 

70O4-re SBH /£/ 

7005-re 52H /R/ 

?006-ra 54H f\ / 

1 7007-re 5BH /E/ 
7D0B-ra 48H /K/ 

tova*bba 7QD9~re 58H 



Teha't a DB utasitassal konnyen tudunk tdblazatokat kgsziteni, 
amelyben szbveg is szerepelhet £s ennek a szb'vegnek rem kell 
nekunk kikeresni minder) betOhdz tartozo* HEX kodot, mert ezt 
automat ikusan elvggzi a program. 

g./ DW operandus 

az OBJECt-File-ban eg 2 bytes sz<5t (cimet) general e"s azt for- 
ditott sorrendben rakja le, ugy ahogy azt a Z-80 megkivanja 
pld.: 

1. ORG 7000H 

2. LOAD 700QH 
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- utasitas-mnemonik: - csak Z-80 utasit^sok lehetnek gs nem 

ismeri a Homelab assembler eltereseit. 
pld.: nem hasznaihatd a MV utasitSs 

- operandusok: - lehetnek regiszternevek 

feltetelnevek 

ASCII LITERAL OK 

szimbolumnevek 

szamjeggyel kezd6d6 Oec. ,Hex.6rtekek, 

kifejez^sek, matematikai miiveletek, 

- megjeffyzes:_ - ;~vel kezdSdfi ASCII karaktersorozat 3 file- 
ban Mrhol elhelyezhet6. A hataWa sor ve- 

gtSlg tart. Ha sorsz^m ut^n ail, akkor az e- 

gesz sor megjegyz^sre haszn3*lhat6. 
VlgySzz, mert ha hosszii megjegyzeseket vagy sok 
betukozt haszn<51sz, akkor a SURCLE-File gyorsan 
nbvekszik 6s elexheti a LOAO-olt programod elejet 

ASSEMBLER HlBAKEZELgS: 

Az assembler a forditSs sor^n magyar hibauzenetet jelez ki. 
A fordit^s az els5 hiba utin leall, 6s kifrja a nibs's sor 
sorszama't, 6s a hibak6dot. 

KEZEU-SI TAHd CSQK A ?fi03fteH0Z4SHn7r 

- a programozasodat ORG utasit^ssal kezrfd 

- a LOAD legala'db 7000H-en kezdfldjbn 

- rbvid cimkgket hasznil^a 

• a cimke utSn legyen betCikdz 

- soron beliil ne haszofild a betuhdz helyett a TAB funkcidt 

- az utasitSsokat es operendusokat nagybetuvel ird 

* ne felejtsd el az END utasitast 

- elfiszdr definiaij £s csak utana hivatkozz ra* 

- ha nines bekbtve a Centronix printer, akkor a P betGt no 
haszna*ld utasitlskeVrt 
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3. UU.I: OS BCH, 55H, 33H 

4. BUfF: OW LALI 

5. Eft) 

A fenti program igy rak> le a byte-kat 
70D0H-ra 6CH 
7Q01H-ra 55H DS 
7002H-ra 33H 
7003H-ra 00H OV 
7D04H-ra 70H 

Tenant a OW a 7000H cimet rakta le, amelyen megtalilhatjuk 
a OB-ben definialt byte-k kezd5-cim6t. Ezek u«n ha BUFF- 
ra hivatkozunk, akkor 32 alatt 7000H-et kell erteniink. 

A forrSsprogram utasitdsa a Z-80 assembler utasita"sai. Iaraeri 
valamennyi standard utasitSst, aroely a Z-80-as CPU utasltfe 
kfczletSben szerepel. A gya*rti5 altal nem appllkalt otasitiso- 
kat a program nem tudja kezelni, rrtivel ezek az utasitasok ktiny- 
nyen helyettesithetfik, illetve f eleslegesek meg egy profi P rog- 
ramoz6 szimSra Is. 



Ktnden programsor 4 mezfit tartelmazhat: 



cuke 



: utasitis-mnemonikj operancfus; megjegyzes 



- ciake: 




- hasznalata nem kbtelezfi. Segitsege^el az u.n 
szimbolikus cimz^st lehet megval6sitani 

- eXs6 karaktere csak betu lehet 

- utasxtdsok, regiszternevek, 6s feltetelkddok 
nem lehetnek az els6 karakterei 

- a cimkgket ;-al kell lezarni 

- a cimke 6s a :-kbzdtt nem lehet SPACE 
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- elfisztir paplron csin^ld meg a pogramodat 

• elflszor a "nagy" programodnak csak kis reszletelt, szubrutijait 
csina"ld meg es csak utana a*llitsd bssze 

• prfibalj meg olyan szubrutinokat csina"lnl, amit m4s feladatok el- 
vegzese*re is tudsz majd alkalmazni 

- Hex. 3000 felett mSr nem iUtszik a m^sodik memdna lapon a prog- 
ramed, ezSrt a kepernyfi kezeliSseket 8000H alatt csinSld meg 
kev$s PUSH muveletet hasznalj, mert egy id6 uta"n roa*r nem tudod 
MJvetni, hogy mit raktSl be 6s vettel elfi 

a cink^ket utolag is be tudod irni az utasitds el6, ha sziikseges, 
ezert nem szukseges a sok cimke, ha nem haszna*lod el csak a he- 
lyet foglalja 

ha a operandusban Hex.-szamot adsz meg, 6s ez a szam betOvel 
kezdodik felte'tlenul irj el egy Q-St 

ahogy n6 a programod, Ogy ta*rold ki rendszeresen magntfra, ne- 
hogy tbbb 6rai munkad vesszen kSrba Sramkimaradas , vagy prog- 
ram hiba miatt. 

RST\utas*t$st*at a szdmok 8-szorosdval kell haszna"lni. 
pld.: az RST5 helyett RST 40 /Dec/ 

RST 28H /Hex/ 



